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5.0 Refer nce 

This section describes the actual OLE Interfaces exposed, the definitions of the data structures 
used when passing data around, and the definitions of each class used internally by the driver. 



5.1 Interfaces 

Other than exposing the standard interfaces IUnknown and ICIassFactory* and the custom, 
extended XMCSPl interfaces, there is only one interface left - the lXMCJ)rvStub interface. 
This interface is used to register the driver, used to perform core XMCSPl operations, with the 
driver stub. The diagram below displays all interfaces exposed by the XMC Driver Stub 
Component. 
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Figure 6 Interface-Map. 

The section below describes the definition of the IXMC_DrvStub interface. For more information 
on the standard OLE interface used see the OLE 2 Programmer *s Reference. And, for more 
information on the extended XMCSPl custom OLE interfaces see the XMCSPl Reference. 

5.L1 IXMC_DrvStub Interface 

The following is the definition of the IXMCJDrvStub interface, 
interface IXMCJDrvStub 



{ 



) ; 



HRESULT RegisterDriver { LPCLSID lpDriverCLSID ); 
HRESULT UnRegisterDriver ( LPCLSID lpDriverCLSID ) 



5.2 Exported Functions 

The following are the functions exported by the driver DLL. 

XMC DRIVERSTUB_MODULET.YPE DLLGetModuleType ( void ); 

LPCLSID DLLGetCLSID ( void ); 

BOOL DLLRegisterServer { void ); 

BOOL DLLUnRegisterServer ( void ); 
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5.3 Structures and D fines 

This section defines all structures, enumerations, and defines used by the driver. 

5.3.1 XMC_DRIVERSTUB_MODULETYPE Enumeration 

The following enumeration is used to mark the module type of the driver stub. 

enum XMC_DRI VERS TUB MODULETYPE 
( 

XMC_DRIVERSTUB_MT - 0x1000 

); 

5 3.2 XMC_EXT_SPI Enumeration 

The following enumeration is used an a function index for all extended XMCSFl functions 
implemented by the CSPIMgr object. 

enum XMC_EXT_SPI 
{ 

XMC_ES_MOVEREL, 

); 

533 XMC_CORE_SPI Enumeration 

The following enumeration is used an a function index for all core XMCSPI functions accessed by 
the CSimpleDriver object. 

enum XMC_EXT_SPI 
• { 

XMC_CS_MOVEABS, 

) ; 

5.4 Classes 

This section contains the definition of all classes used by the driver stub component in its 
implementation. 

5.4.1 CDriverStubDisp Class 

The CDriverStubDisp class acts as the dispatch, or control, object used to separate all OLE 
details from the code implementing the driver internals. This object coordinates all operations 
taking place in the driver by directing other C++ object to cany out the work of the operation. The 
following is the definition of the CDriverStubDisp class. 

class CDriverStubDisp 
{ 

public: 

// Constructors & Destructors 

CDriverStubDisp ( void ); 
-CDriverStubDisp ( void )/ 

. // IXMC_DrvStub Methods 

DWORD RegisterDriver ( LPCLSID lpDriverCLSID ) ; 
DWORD UnRegisterDriver { LPCLSID lpDriverCLSID ); 

// Actions ' 

DWORD FireExtSPK XMC_EXT_SPI extspilD, ... ) 



ROY-G-BIV Corporation C nfldentlal 



5/16/95 



XMC Motion Control - Driver Stub Design 



5.0 Reference 



private: 

// Private Data 

CSPIMgr m spiMgr; 

I; 

5.4.2 CSPIMgr Class 

The CSPIMgr implements software simulations of each extended XMCSPl function. The 
CSimpleDriver object is used to perform all core XMCSPl operations used in the simulations. 
The definition of the CSPIMgr class is as follows. 

class CSPIMgr 
( 

public: 

// Constructors & Destructors 

CSPIMgr < void ) ; 
-CSPIMgr ( void ) ; 

// Initialization 

DWORD Initialize ( LPCLSID lpDriverCLSID ); _ 

// Extended SPI Methods 

DWORD FireExtSPI ( XMC_EXT_SPI extspilD, ... ) ; 

private : 

// Private Ext SPI Simulation Functions 



// Private Data 

CSimpleDriver m_s imple Drive r; 

I; 
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5.4.3 CSimpleDriver Class 

The CSimpleDriver is used to communicate with the XMC Driver that performs the core XMCSPI 
functions. All OLE operations are encapsulated within this object. The definition of the 
CSimpleDriver is as follows. 

class CSimpleDriver 
{ 

public: 

// Constructors 6 Destructors 

CSimpleDriver { void ); 
-CSimpleDriver ( void ); 

// Initialization 

DWORD Initialize ( LPCLSID lpDriverCLSID ); 
DWORD LoadCorelnterf aces ( void ) ; 
DWORD LoadExtlnterf aces ( void ); 

// Actions 

DWORD FireCoreSPK XMC_COR£_SPI corespilD, ... ); 
DWORD FireExtSPI ( XMC_EXT_SPI extspilD, ... ) ; 

private: 

// Private Data 

LPFNCORESPI m_rgCoreSPIf XMC_CORE_SPI_COUNT ]; 
BOOL m bCoreSPIEnabled; 



LPFNEXTSPI m rgExtSPIf XMC_EXT_SPI_COUNT J; 
BOOL nfbExtSPIEnabled; 
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